home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / Apple II / Essentials / Essentials.sea / File.Type.Notes / FTN.B3.XXXX < prev    next >
Encoding:
Text File  |  1993-06-15  |  3.3 KB  |  72 lines  |  [TEXT/GEOL]
  1.  Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. File Type:       $B3 (179)
  7. Auxiliary Type:  All
  8.  
  9. Full Name:       ProDOS 16 or GS/OS Application
  10. Short Name:      GS/OS Application
  11.  
  12. Revised by:      Dave Lyons May 1992
  13. Written by:      Dave Lyons & Matt Deatherage                  September 1989
  14.  
  15. Files of this type and auxiliary type contain application programs for the
  16. Apple IIgs.
  17.  
  18. CHANGES SINCE DECEMBER 1991:  Broadened the definition auxiliary type bit 1 to
  19. mean the application can handle getting control with the Super Hi-Res screen
  20. on.
  21. _____________________________________________________________________________
  22.  
  23.  
  24. Files of type $B3 contain GS/OS application programs.  These files contain
  25. program code in Object Module Format (OMF) that is loaded by the System Loader
  26. or ExpressLoad at an address and is then executed in a documented environment.
  27.  
  28. The environment and constraints for application programs are documented in
  29. GS/OS Reference; all developers creating file of type $B3 should be familiar
  30. with this material.  OMF is documented in _GS/OS Reference_ and the
  31. _APW Reference Manual._
  32.  
  33. The auxiliary type for $B3 files is now defined to indicate properties of the
  34. program contained within the file.  Other parts of the system may use this
  35. information to properly control the environment for the program:
  36.  
  37.  
  38.      bits 31-16        reserved--must be 0
  39.      bits 15-8         signature byte.  $DB means bits 7-0 are valid
  40.      bits 7-3          reserved--must be 0
  41.      bit 2             Message Aware:
  42.                        1 = uses Message Center message #1
  43.                        0 = ignores Message Center message #1
  44.      bit 1             Desktop Application:
  45.                        1 = application can handle the Super Hi-Res
  46.                            screen already being on when it first gets
  47.                            control, so the system can provide a smooth
  48.                            visual transition into the application
  49.                        0 = application is not prepared for the Super
  50.                            Hi-Res screen to be on
  51.      bit 0             GS/OS Aware:
  52.                        1 = uses long prefixes (for example, prefix 9
  53.                            instead of prefix 1)
  54.                        0 = uses short prefixes (less than 63 characters)
  55.  
  56.    NOTE: If an application has the Desktop Application bit set, it
  57.          should be prepared to get control with either the text or
  58.          the Super Hi-Res screen visible.  For example, if some
  59.          error prevents the application from using the desktop
  60.          tools, it may be necessary to call GrafOff before the
  61.          user can read error messages displayed on the text screen
  62.          (although GrafOff is a QuickDraw II call, it's OK to call
  63.          GrafOff even if QuickDraw II is not active).
  64.  
  65.          If an application does not have the Desktop Application
  66.          bit set (or does not even have a $DBxx auxiliary type),
  67.          the system software reserves the right to force the text
  68.          screen to be visible if QuickDraw II is not started.  Do
  69.          not assume that a Quit call from one application to
  70.          another (with QuickDraw II not started) will leave the
  71.          Super Hi-Res screen visible.
  72.